<script type="text/javascript"
     src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<head>
    <link rel="stylesheet" href="stylesheet_TMATS.css">
</head>

<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<title>
    T-MATS: Help for Burner (Cantera) Library Block
</title>

<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<body>
    <h1>
      T-MATS: Burner (Cantera) Library Block
    </h1>
<hr>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="purpose">
        Purpose
</div>

<p>
    This block is used to simulate the performance of a burner using <a href="FunM_TMATSC.html">T-MATS Cantera functions</a>
    , thermodynamic equations and properties.
</p>

<br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="background">
        Background
</div>
<p>
    To compute the output parameters, this block begins by translating the
    incoming flow data into two variables, FI and F0, the latter of which is
    used as a starting point for the combustion.
</p>


<p>
    The exit total pressure is then calculated using the following equation
    and the user-specified pressure drop (<i>dP</i>).

    $$Pt_{Out} = Pt_{In} * (1-dP)$$

    The output fuel flow is determined by the following equation:

    $$W_{fuel} = W_{In} * FAR$$
    $$FAR = \frac{W_{fuel}}{W_{In}} $$
    Note: <i>W<sub>fuel</sub></i> refers to species 3 (as defined in canteraload.m).
    Also, for this block fuel to air ratio (<i>FAR</i> refers only to fuel added by this block.
    <br><br>

    The total temperature of the fuel is set to be equal to the total temperature
    of the flow and the total enthalpy of the fuel is set to the user-specified
    value. The fuel flow is then added to the rest of the gas path flow (using <a href="FunM_TMATSC.html">T-MATS Cantera functions</a>) to
    determine the total flow.
</p>
<p>
    Unless adjusted by one of the previous equations, all of the other flow
    variables remain constant across this block.
</p>

<br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="instructions">
        Instructions
</div>

<p>
    To use this block:
    <ul>
        <li> Ensure that a Cantera object exists in the workspace as a global
        variable named 'fs' and contains all of the species defined in the
        file 'canteraload.m'.
        <br>
        &nbsp;&nbsp;<em>Note:</em>This can be created with the Cantera 'importPhase'
        command.
        <li> Connect the flow input to the corresponding place on the block.
        <li> Connect the outputs to the next blocks in your simulation.
        <li> Double click the block and specify the fuel to air ratio, enthalpy
        of the fuel, and the change in pressure across the burner.
    </ul>
</p>


<br><hr><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="inputs">
        Burner (Cantera) Inputs
</div>

<table>
    <tr><th> Input </th><th>Description</th></tr>
    <tr><td>FuelFlwIn</td><td>Fuel Flow Input [pps]</td></tr>
    <tr><td>Flow In</td><td>Flow Data Input, 25x1 vector consisting of:
            <br>-1-&nbsp;&nbsp; W &nbsp;&nbsp;     - Gas path flow [pps]
            <br>-2-&nbsp;&nbsp; s &nbsp;&nbsp;    - Entropy [BTU/(lbm*degR)]
            <br>-3-&nbsp;&nbsp; Tt &nbsp;&nbsp;    - Total temperature [degR]
            <br>-4-&nbsp;&nbsp; Pt &nbsp;&nbsp;    - Total pressure [psia]
            <br>-5-&nbsp;&nbsp; ht &nbsp;&nbsp;    - Total enthlapy [BTU/lbm]
            <br>-6-&nbsp;&nbsp; rhot &nbsp;&nbsp; - Total density [lbm/ft3]
            <br>-7-&nbsp;&nbsp; gamt &nbsp;&nbsp; - Total specific heat ratio
            <br>-8-&nbsp;&nbsp; Ts &nbsp;&nbsp;   - Static temperature [degR]
            <br>-9-&nbsp;&nbsp; Ps &nbsp;&nbsp;   - Static pressure [psia]
            <br>-10-&nbsp;&nbsp; hs &nbsp;&nbsp;   - Static enthalpy [BTU/lbm]
            <br>-11-&nbsp;&nbsp; rhos &nbsp;&nbsp; - Static density [lbm/ft3]
            <br>-12-&nbsp;&nbsp; gams &nbsp;&nbsp; - Static specific heat ratio
            <br>-13-&nbsp;&nbsp; Vflow &nbsp;&nbsp; - Flow velocity [ft/sec]
            <br>-14-&nbsp;&nbsp; MN &nbsp;&nbsp; - Mach number
            <br>-15-&nbsp;&nbsp; A   &nbsp;&nbsp;  - Flow area [in2]
            <br>-16to21-&nbsp;&nbsp; Species array values, defined in canteraload.m
            <br>-22to25-&nbsp;&nbsp; Future use
        </td></tr>
</table>

<br><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="outputs">
        Burner (Cantera) Outputs
</div>

<table>
    <tr><th> Output </th><th> Description </th></tr>
    <tr><td>Flow Out</td><td>Flow Data Output, 25x1 vector consisting of:
            <br>-1-&nbsp;&nbsp; W  &nbsp;&nbsp;    - Gas path flow [pps]
            <br>-2-&nbsp;&nbsp; s  &nbsp;&nbsp;   - Entropy [BTU/(lbm*degR)]
            <br>-3-&nbsp;&nbsp; Tt &nbsp;&nbsp;    - Total temperature [degR]
            <br>-4-&nbsp;&nbsp; Pt &nbsp;&nbsp;    - Total pressure [psia]
            <br>-5-&nbsp;&nbsp; ht  &nbsp;&nbsp;   - Total enthlapy [BTU/lbm]
            <br>-6-&nbsp;&nbsp; rhot &nbsp;&nbsp; - Total density [lbm/ft3]
            <br>-7-&nbsp;&nbsp; gamt &nbsp;&nbsp; - Total specific heat ratio
            <br>-8-&nbsp;&nbsp; Ts  &nbsp;&nbsp;  - Static temperature [degR]
            <br>-9-&nbsp;&nbsp; Ps  &nbsp;&nbsp;  - Static pressure [psia]
            <br>-10-&nbsp;&nbsp; hs  &nbsp;&nbsp;  - Static enthalpy [BTU/lbm]
            <br>-11-&nbsp;&nbsp; rhos &nbsp;&nbsp; - Static density [lbm/ft3]
            <br>-12-&nbsp;&nbsp; gams &nbsp;&nbsp; - Static specific heat ratio
            <br>-13-&nbsp;&nbsp; Vflow &nbsp;&nbsp; - Flow velocity [ft/sec]
            <br>-14-&nbsp;&nbsp; MN &nbsp;&nbsp; - Mach number
            <br>-15-&nbsp;&nbsp; A   &nbsp;&nbsp;  - Flow area [in2]
            <br>-16to21-&nbsp;&nbsp; Species array values, defined in canteraload.m
            <br>-22to25-&nbsp;&nbsp; Future use
        </td></tr>
    <tr><td>Wfuel</td><td>Fuel flow [pps]</td></tr>
    <tr><td>B_Data</td><td>Burner internal calculation data</td></tr>
</table>

<br><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class="maskvars">
        Burner (Cantera) Mask Variables
</div>

<table>
    <tr><th> Mask Variable </th><th> Description </th></tr>
    <tr><td>FAR_M</td><td>Fuel to air ratio</td></tr>
    <tr><td>hFuel_M</td><td>Enthalpy of the input fuel [BTU/lbm]</td></tr>
    <tr><td>dP_M</td><td>Normalized burner &Delta;P accross the burner [1 - psi/psi]</td></tr>
</table>


<br><hr><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->

<div class = "errors">
    Potential Errors
</div>
<p>
When using this block, an error will occur if a Cantera object does not exist
in the workspace as a global variable named 'fs'. An error will also occur
if this variable does not contain all of the species defined in 'canteraload.m'.

<br><br>
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
</body>